…lakeblackshear#21946)

* docs: Add frame selection and clean copy details to snapshots docs

Document how Frigate selects the best frame for snapshots, explain the
difference between regular snapshots and clean copies, fix internal
links to use absolute paths, and highlight Frigate+ as the primary
reason to keep clean_copy enabled if regular snapshot is configured clean.

* revert - do not use the word event

* rm clean copy is only saved when `clean_copy` is enabled

* Simplified the Frame Selection section down to a single paragraph.

* rm note about snapshot file ext change from png to webp

---------

Co-authored-by: Kai Curry <kai@wjerk.com>

Mermaid compatible newlines (<br>)

…r#21942)

* Add detail to face recognition MQTT update docs

Clarify that the weighted average favors larger faces and
higher-confidence detections, that unknown attempts are excluded,
and document when name/score will be null/0.0.

* Fix score decimal in MQTT face recognition documentation

`0.0` in JSON is just `0`.

* Clarify score is a running weighted average

* Simplify MQTT tracked_object_update docs with inline comments

Move scoring logic details to face recognition docs and keep
MQTT reference concise with inline field comments and links.

* fix (expand) lpr doc link

* rm obvious lpr comments

---------

Co-authored-by: Kai Curry <kai@wjerk.com>

* update HA docs with MQTT example

* format block as yaml

* Docs: fix missing dependency in YOLOv9 build script

I had this command fail because it didn't have cmake available.

This change fixes that problem.

* Docs: avoid failure in YOLOv9 build script

Pinning to 0.4.36 avoids this error:

```
10.58  Downloading onnx
12.87    Building onnxsim==0.5.0
1029.4   × Failed to download and build `onnxsim==0.5.0`
1029.4   ╰─▶ Package metadata version `0.4.36` does not match given version `0.5.0`
1029.4   help: `onnxsim` (v0.5.0) was included because `onnx-simplifier` (v0.5.0)
1029.4         depends on `onnxsim`
```

* Update Dockerfile instructions for object detectors

---------

Co-authored-by: Nicolas Mowen <nickmowen213@gmail.com>

* fix config examples

* remove reference to trt model generation script

* tweak tmpfs comment

* update old version

* tweak tmpfs comment

* clean up and clarify tensorrt

* re-add size

* Update docs/docs/configuration/hardware_acceleration_enrichments.md

Co-authored-by: Nicolas Mowen <nickmowen213@gmail.com>

---------

Co-authored-by: Nicolas Mowen <nickmowen213@gmail.com>

0.17 Release

* Fix go2rtc stream alias authorization and live audio gating for main/sub stream names

* revert

* add tests

* permit birdseye access if user has viewer role or a custom viewer role that has access to all cameras

* bump version

* fix genai leak

* Add fix for value error in embedding

* Cleanup

users without frigate+ enabled would not have the ability to create an object mask from the 3-dots menu in tracking details

* prevent short hls segments by extending clip backwards

* clean up

* snap to keyframe instead of arbitrarily subtracting time

* formatting

* "fix: correct ArcFace input format for RKNN runner"

* ruff format

Co-authored-by: ARandomGitHubUser <7754708+ARandomGitHubUser@users.noreply.github.com>

…ckshear#22331)

* fix environment_vars timing bug for EnvString substitution

FRIGATE_ENV_VARS is populated at module import time but was never
updated when environment_vars config section set new vars into
os.environ. This meant HA OS users setting FRIGATE_* vars via
environment_vars could not use them in EnvString fields.

* add EnvString support to MQTT and ONVIF host fields

* add tests

* docs

* update reference config

file needs to be blank if not using homekit, not {}
it seems like go2rtc is not parsing {} as yaml

…kshear#22349)

* add util for optimal detect resolution

* add detect to type

* save optimal detect resolution to config on wizard save

* use const

…r#22385)

* filter push notifications by user camera access with cached role resolution

* simplify

nav buttons would be hidden when closing and reopening dialog after selecting the tracking details pane

…lakeblackshear#22416)

keep None at the bottom

…kshear#22439)

…lakeblackshear#22454)

Co-authored-by: eduard256 <ceo@webaweba.com>

…22492)

* docs: remove onvif host environment variable

* Update ONVIF configuration notes in reference.md

…non-admin users (blakeblackshear#22523)

…r#22522)

* Fix cross-camera authorization bypass in timeline and event media endpoints

* formatting

* validate preview filename and camera access

* correctly handle camera names with dashes